home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / comm / fido / ttrxid13.lha / TrapTrxID.doc.italiano < prev   
Text File  |  1993-01-31  |  10KB  |  245 lines
  1.  
  2.  
  3.                \\\\\\\\\\\\\\\\\\\\////////////////////
  4.                             Manuale d'uso
  5.                                   di
  6.  
  7.                               TrapTrxID
  8.                                  v1.3
  9.                           Time Synchronizer
  10.  
  11.                                   di
  12.                            Giuseppe Vicari
  13.                        2:331/105.4@Fidonet.Org
  14.                ////////////////////\\\\\\\\\\\\\\\\\\\\
  15.  
  16.  
  17.  
  18.  
  19. ****    Indice                                                   Linea
  20.  
  21.     .   Che cosa e`?                                                35
  22.     .   Cosa serve?                                                 44
  23.     .   Perche` usare TrapTrxID?                                    54
  24.     .   Come si usa?                                                78
  25.     .   Note particolari riguardanti TrapDoor?                     112
  26.     .   Come funziona?                                             128
  27.     .   Bug e problemi?                                            159
  28.     .   Come contattarmi in caso di problemi?                      173
  29.     .   La storia di TrapTrxID?                                    181
  30.     .   Quanto costa il programma?                                 214
  31.     .   Come assicurarsi dell'originalita` del programma?          232
  32.     .   Fine documento                                             245
  33.  
  34. ****    Fine indice
  35.  
  36. >>>>    Che cosa e`?
  37.  
  38.     TrapTrxID e` un piccolo tools costruito per TrapDoor, che permette
  39. di  sincronizzare  l'orologio  di sistema, utilizzando le informazioni
  40. che si trovano nel file log di TrapDoor, informazioni generate durante
  41. un  collegamento  di  tipo  EMSI  con  il  nodo  con  cui  ci si vuole
  42. sincronizzare.
  43.  
  44.  
  45. >>>>    Cosa serve?
  46.  
  47.     Alcuni  nodi  possono  avere  l'ora di sistema sincronizzata con i
  48. famosi  orologi  atomici,  utilizzando  apparecchiature  particolari o
  49. collegandosi  ad  altri  nodi.   In  questo modo utilizzando TrapTrxID
  50. potrai sempre avere il tuo orologio regolato su l'ora esatta, tutto in
  51. maniera  automatica, semplicemente collegandoti con il nodo con cui ti
  52. vuoi sincronizzare con TrapDoor e poi lanciare TrapTrxID.
  53.  
  54.  
  55. >>>>    Perche` usare TrapTrxID?
  56.  
  57.     Questo  programma  rispetto a quelli gia` presenti in circolazione
  58. offre alcuni vantaggi, che gli altri programmi non offrono:
  59.  
  60.     1. Il  programma  e`  stato  concepito  per essere il piu` corto e
  61.        veloce programma in circolazione.
  62.  
  63.     2. Rispetto  agli  altri programmi, analizza completamente il file
  64.        di  log  evitando  di  perdere  dati nel caso l'ultima sessione
  65.        risulta particolarmente lunga.
  66.  
  67.     3. Informa  il  sistema,  scrivendo  una  linea nel file di log di
  68.        TrapDoor, che il programma ha eseguito una sincronizzazione.
  69.  
  70.     4. Utilizzando   la  riga  inserita  nel  file  di  log  evita  di
  71.        risincornizzare  l'ora  di sistema se si riesegue piu` volte il
  72.        programma.
  73.  
  74.     5. Il programma e` di tipo PURE quindi puo` essere reso residente,
  75.        in  questo modo e` possibile lanciarlo piu` volte senza doverlo
  76.        caricare ogni volta dall'unita` di massa.
  77.  
  78.  
  79. >>>>    Come si usa?
  80.  
  81.     TrapTrxID  si  puo` usare in due modi:  il primo modo consiste nel
  82. lanciare  da  CLI o da un particolare file script (es.  User-StartUp o
  83. StartUp-Sequences),  il  secondo  modo consiste nel lanciare TrapTrxID
  84. subito  dopo  la  terminazione  di una sessione EMSI in questo modo la
  85. sincronizzazione  avviene  ad  ogni  sessione,  questa  possibilita e`
  86. offerta  da  TrapDoor  usando  l'opzione  AFTERSESSION (vedi documenti
  87. allegati al pacchetto di TrapDoor).
  88.  
  89.     I  parametri  da passare a TrapTrxID sono rispettivamente, il nome
  90. completo del file di log di TrapDoor ,compreso il path per raggiungere
  91. il  file,  e  il  numero del nodo con cui ci si vuole sincronizzare; i
  92. parametri  dell'indirizzo non specificati vengono considerati uguale a
  93. 0,  nel  caso  non si specifica il nodo con cui sincronizzarsi, questa
  94. operazione  viene  fatto con l'ultimo nodo con la quale e` stata fatta
  95. una sessione EMSI.
  96.  
  97.     Esempio primo modo:
  98.  
  99. TrapTrxID Mail:Logs/TrapDoor.log 2:333/100.0
  100.  
  101.     Inserire  questa  stringa  in  un  file  di  script,  o usarla per
  102. lanciare TrapTrxID da CLI.
  103.  
  104.     Esempio secondo modo:
  105.  
  106. AFTERSESSION "TrapTrxID %l 2:333/100.0"
  107.  
  108.     Inserire questa stringa nel file di configurazione di TrapDoor, la
  109. stringa  %l  viene  sostituita automaticamente da TrapDoor con il nome
  110. completo del file di log.
  111.  
  112.  
  113. >>>>    Note particolari riguardanti TrapDoor?
  114.  
  115.     Questa  versione  e` stata sviluppata utilizzando la versione 1.83
  116. di  TrapDoor,  ma si puo` utilizzare una qualsiasi versione precedente
  117. purche`  sia  compatibile  con  questa versione, cioe` che permetta di
  118. ricevere  i messaggi TrxId, Name o AKA; questo lo potrai controllare e
  119. verificare   leggendo   attentamente   le  istruzioni  di  TrapDoor  e
  120. controllando  che  il  comportamento  del  programma  si  adeguato  al
  121. funzionamento di TrapTrxID.
  122.  
  123.     Una  nota  particolare  va  fatta  sul  file  di configurazione di
  124. TrapDoor,  infatti  in  questo  file  deve  essere presente la stringa
  125. LOGLEVEL  8:n con n maggiore di 2, per far in modo che TrapTrxID possa
  126. analizzare e trovare le linee necessarie per sincronizzarsi.
  127.  
  128.  
  129. >>>>    Come funziona?
  130.  
  131.     TrapTrxID funziona semplicemente cercando nel file di log le linee
  132. di questo tipo:
  133.  
  134. : 26-Dec-92 12:11:01   Name: Nome BBS (2:334/155.0)
  135. : 26-Dec-92 12:11:01    AKA: 2:23331/1.0 3:1/1.0
  136.  
  137. e  verificando che l'indirizzo specificato come parametro coincida con
  138. uno  di  quelli  presenti  in  queste  due  linee,  se cio` avviene la
  139. prossima linea di questo tipo:
  140.  
  141. : 26-Dec-92 12:11:01  TrxID: 2b3c4bd0/2b3c4ad7
  142.  
  143. servira` per calcolare la differenza temporale tra il proprio orologio
  144. di  sistema  e  quello  del  nodo  col  la  quale abbiamo eseguito una
  145. sessione  EMSI, esattamente calcolando la differenza dei due parametri
  146. esadecimali,  presenti  dopo  la  parola  chiave  TrxID:, ricavando la
  147. differenza  in  secondi  dell'ora  del nodo locale con quella del nodo
  148. remoto.   Naturalmente questa operazione viene fatta considerando solo
  149. l'ultima   sessione;   una  volta  che  l'orologio  viene  aggiornato,
  150. TrapTrxID aggiunge una linea di questo tipo:
  151.  
  152. " 26-Dec-92 12:34:24  TrapTrxID v1.3 Adjusted by -249 sec (3:1/1.0)
  153.  
  154. in questo modo TrapTrxID non riaggiorna piu` l'ora fintanto che non si
  155. effettua  un'altra  sessione  EMSI con tale nodo; questo tipo di linea
  156. permette a TrapTrxID di capire se e` stata fatta una sincronizzazione.
  157.  
  158.  
  159. >>>>    Bug e problemi?
  160.  
  161.     Fino  ad  oggi, io non ho riscontrato nessun tipo di bug in questo
  162. programma,  ma esiste un unico problema ed e` quello che risulta lento
  163. quando  il  file  di  log  e`  molto  lungo, questo perche` esegue una
  164. scansione  completa  del  file, cosa che non fanno altri programmi, ma
  165. credo  che  il problema non sia un gran che rilevante, in oltre questa
  166. scansione assicura una corretta analisi del file di log.
  167.  
  168.     Faccio  notare  che TrapTrxID non aggiorna l'orologio hardware del
  169. calcolatore  presente  in  quasi  tutte  le  macchine,  ma solo quello
  170. gestito  dal  sistema  operativo,  se volete aggiornare quello interno
  171. dovete usare il comando setclock.
  172.  
  173. >>>>    Come contattarmi in caso di problemi?
  174.  
  175.     Per  ogni  eventuale  problema  o  bug  da me non rilevato, potete
  176. contattarmi al seguente indirizzo e-mail:
  177.  
  178.                Giuseppe Vicari 2:331/105.4@Fidonet.Org
  179.  
  180.  
  181. >>>>    La storia di TrapTrxID?
  182.  
  183.     Qui  troverete  un  piccolo  resoconto  della storia di TrapTrxID;
  184. versioni rilasciate, bug trovati e corretti, e alcune mie note:
  185.  
  186.     . v1.3 Jan 31 1993:
  187.  
  188.         E`  stato  sistemato  un  difetto  che  mandava  in  crash  il
  189.     calcolatore, a causa dell'ottimizzatore del compilatore.
  190.  
  191.     . v1.2 Jan 30 1993:
  192.  
  193.         Ora  e`  possibile non specificare il nome del nodo con cui ci
  194.     si   vuole   sincronizzare,  in  questo  modo  verra`  considerato
  195.     l'ultimo.   Nel caso venga lanciato da WorkBench il programma apre
  196.     una   finestra  e,  dopo  aver  mostrato  la  sintassi  d'uso  del
  197.     programma,  la  richiude  dopo 5 secondi.  E` stata disattivato la
  198.     gestione  automatica del input/output (cioe` dello stdio) da parte
  199.     della  procedura  main, utilizzando quella di tipo TINY, in questo
  200.     modo il codice risulta piu` corto.
  201.  
  202.     . v1.1 Jan 22 1993:
  203.  
  204.         Corretto un piccolo bug insignificante (nel file log, scriveva
  205.     l'ora senza lo zero davanti alla cifra se era minore di 10; es.  9
  206.     invece  di  09),  aggiunto  un messaggio d'errore, e riottimizzato
  207.     alcune parti del programma.
  208.  
  209.     . v1.0 Jan  3 1993:
  210.  
  211.         Prima versione.
  212.  
  213.  
  214. >>>>    Quanto costa il programma?
  215.  
  216.     Il  programma  puo`  essere  distribuito  e  usato  liberamente  e
  217. gratuitamente,  purche`  non  alterate nessuna sua parte ne` il codice
  218. ne`  la  documentazione  allegata;  infatti  questo e` un programma PD
  219. (Pubblic  Domain), ma saro` molto lieto di accettare qualunque offerta
  220. di  denaro  $-),  anzi  desidererei  molto  ricevere una cartolina del
  221. vostro  paese, anzi una bella cartolina.  L'indirizzo per ogni tipo di
  222. offerta e` il seguente:
  223.  
  224.                            Giuseppe Vicari
  225.                              via Torni, 7
  226.                         I-21051 Arcisate (VA)
  227.                                 ITALIA
  228.  
  229.     Ringrazio anticipatamente ogni vostra offerta.
  230.  
  231.  
  232. >>>>    Come assicurarsi dell'originalita` del programma?
  233.  
  234.     All'interno   dell'archivio   e`   stato  inserito  un  programma,
  235. CheckFiles, per verificare l'originalita` del programma e del manuale,
  236. in  questo  modo  tutti  potranno controllare se il programma e` stato
  237. manomesso  o  addirittura  infettato  da  qualche  virus.   Dopo  aver
  238. estratto  i  file  dall'archivio  si  lancia  il programma CheckFiles,
  239. stando  attenti a come scrivete il nome del programma (la prima C e la
  240. F  sono  maiuscole  mentre  le  altre  minuscole)  e lanciandolo dalla
  241. directory  dove si trovano i file estratti; il programma vi segnalera`
  242. i file che sono stati alterati.
  243.  
  244.  
  245. >>>>    Fine documento